home *** CD-ROM | disk | FTP | other *** search
/ HyperLib 1997 Winter - Disc 1 / HYPERLIB-1997-Winter-CD1.ISO.7z / HYPERLIB-1997-Winter-CD1.ISO / オンラインウェア / COM / ProTERM Mac1.2a.sit / ProTERM Mac1.2a / Macros / Contributed / Moxie's Cool Stuff / Finger / Finger Documentation < prev   
Text File  |  1996-07-22  |  6KB  |  76 lines
  1. ** Finger **
  2.  
  3. ProTERM Mac 1.2 Finger Macro 1.1a
  4. Mark Mentovai - mark@moxienet.com - http://www.moxienet.com/
  5. July 19, 1995
  6.  
  7. Copyright ｩ 1996 Mark Mentovai.  All rights reserved.  This program may be distributed freely in electronic form, so long that nothing is charged for it, and it is distributed with all documentation and macro code intact.  Should you wish to include this macro in an archive or collection, contact the author for information.
  8.  
  9. This macro connects to a finger server from any TCP/IP-connected Macintosh.  It was intended for use with the Internet.  To use, enter a username@host combination in the Finger: field, leave the Port set to 79, and press OK.   Requires ProTERM Mac 1.2 and MacTCP or Open Transport TCP/IP.  Finger can also be used as a whois client.  Select "whois" from the "Common" popup menu, and enter a lookup@whois.internic.net combination in the Finger: field.
  10.  
  11. Revision History:
  12. 19960714    1.0    Initial version.  Output is left in term scrollback window
  13.                    when program terminates.  Because the whois format differs
  14.                    very slightly from finger, it is incompatible with whois.
  15. 19960718    1.1    Added support for whois and a popup menu to switch between
  16.                    finger and whois.  Finger now captures the output to a
  17.                    temporary file which is made read-only before opening as an
  18.                    editor document (this facilitates the hiding of the
  19.                    insertion point).
  20.  
  21. ** What is Finger? **
  22.  
  23. The Finger User Information Protocol (documented in RFC 1196) was developed for use on the Internet as a standard way of finding out who is logged in at a certain time, whether or not their mail has been read, how long they have been idle, and other things.  Finger programs have been standard equipment on UNIX boxes for a long time: they are very simple applications that connect to a remote server and ask for data on one user.  The server sends the data back, and both computers are happy.  Finger programs can also ask for data about all of the users logged in to the system, as well.
  24.  
  25. This implementation of Finger requires ProTERM Mac 1.2 and provides a very nice interface to this finger system.  In addition, it also provides access to Whois (documented in RFC 954), a protocol very similar to Finger, which is utilized in looking up registered domain names on the Internet.
  26.  
  27. ** Using Finger **
  28.  
  29. The operation of Finger is simple: after ProTERM Mac is instructed to interpret the Finger macro, you will be presented with a dialog box, with the following options:
  30.  
  31. Finger:    This is where you enter the username@host combination of the person
  32.     which you are "fingering".  Examples include "moxie@liii.com" and
  33.     "foo@bar.edu".  Hostnames alone can also be entered in this field:
  34.     "liii.com" is acceptable, as is "@liii.com" (both produce the same
  35.     result, but "@liii.com" is more commonly used on Unix - also, I plan
  36.     to disable the lookup of hosts without the leading "@" in a future
  37.     revision).
  38. Port:    For fingering, you may leave the port set to 79, this is the port on
  39.     which finger servers operate.  Whois operates on port 43, so you may
  40.     use that as well.  If you have a need to use another port, do so, but
  41.     for every application I use Finger for, 79 and 43 are just fine.
  42. Common:    A nifty popup menu that will set Port to its appropriate value.  If
  43.     you set Common to "79: Finger", the Port will change to 79
  44.     automatically, and if the "Finger:" field contains
  45.     "@whois.internic.net" (the default whois string), it will be removed.
  46.     When Common is set to "43: Whois", the Port will change to 43, and
  47.     if the "Finger:" field contains nothing, "@whois.internic.net" will
  48.     be inserted.  Whois.internic.net is the standard whois host - it
  49.     allows you to search the Whois database of registered domains,
  50.     nameservers, networks, and InterNIC contacts.  To search a Whois
  51.     server, enter lookup@host - most commonly, lookup@whois.internic.net.
  52.     Whois servers will display help text if you lookup "help@host" - where
  53.     host is your whois server.  For example, looking up
  54.     "intrec.com@whois.internic.net" pulls up the record for InTrec.
  55.  
  56. Clicking "OK" or pressing RETURN will proceed with the finger operation.  "Cancel" and the close box both close the window and stop the macro from running.  I would like to add COMMAND-. support for the Cancel button if I could only figure out how.  :)
  57.  
  58. After clicking "OK", the Finger program will go and do its thing: you will see a few windows open and close on the screen before you are presented with the final output, in the form of a ProTERM Mac read-only editor document.  To get out of it, just close the window.
  59.  
  60. If you encounter a "Finger Failed" error, one of the following probably occurred:
  61. "Could not connect to the finger server": the hostname you specified doesn't
  62.     exist or could not be reached.
  63. "Invalid address format": the address you entered ends in an "@", so Finger
  64.     can't figure out what to do.
  65. "Bad port number": you tried to make Finger break by telling it port 0 or
  66.     entering a text string in the "Port:" field.
  67.  
  68. ** Bugs **
  69.  
  70. I'd still like to change a few things around in finger.  I think I've nailed almost all of the bugs, but occasionally if Finger is terminated at the wrong time, a Remote Print File will be left in the ProTERM folder and Finger won't work correctly until it's removed.  I'd like to fix this bug, but the file for the Printer Capture doesn't appear to be changeable.  To rectify, remove the Online Print files from your ProTERM folder if you see them there, or if you suspect something screwey is happening with Finger.
  71.  
  72. I'd also like to add a few small cosmetic things - like the COMMAND-. shortcut to cancel, and possibly hide the windows that pop up.
  73.  
  74. # # #
  75.  
  76. That's all there is to Finger.  It's a neat little macro, I hope you enjoy it!